home *** CD-ROM | disk | FTP | other *** search
/ MacHome 2000 March / MacHome CD (March 2000).iso / pc / Games / ACE! 1.7.2.sit / ACE! 1.7.2 / Read Me < prev    next >
Text File  |  2000-01-08  |  8KB  |  130 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8. ACE! 1.7.2 by Richard Drysdall © Flying Horse Software 1997-2000. All rights reserved.
  9.  
  10.  
  11. Introduction
  12.  
  13. ACE! allows you to edit the 'save game' documents created by many commercial and shareware games (these documents are referred to as 'characters' by some games). Additionally, ACE! allows you to print details of these save games.
  14.  
  15. Initially, you can edit the save games from Abuse, Bard's Tale, Curse of Dragor, Curse of the Azure Bonds, Cythera, Damage Incorporated, Death Blade, Doom (1, 2 and Ultimate), Dragon Blade, Escape Velocity (standard and Override), Fallout, Foobar vs the DEA, Harry the Handsome Executive, Heroes of Might & Magic (1 and 2), Jewel of Arabia - Dreamers, King's Bounty, Mantra, Marathon (1, 2, Infinity, Excalibur and Evil), Master of Orion, Might and Magic (1, 2 and 3), Odyssey, Omega, Pathways into Darkness, Pool of Radiance, Prime Target, Realmz (6 and 7), System Shock, Ultima III, Unlimited Adventures, Wizardry Gold, Yipe! (2 and 3) and ZPC. However, ACE! can be extended to edit other save games through the use of plug-in 'modules'.
  16.  
  17. ACE! is scriptable, and (partially) recordable, and a number of example scripts are provided that extend ACE. You can also make your own scripts to automate your use of ACE.
  18.  
  19. ACE! is freeware. The most recent version of ACE! is available from Info-Mac and it's mirror sites, or from the official ACE web page, http://www.crosswinds.net/~drysdall/ace.html (or http://homepages.ihug.co.nz/~drysdall/ace.html).
  20.  
  21.  
  22. Requirements
  23.  
  24. ACE! will run on any Macintosh or MacOS compatible computer. It requires a minimum of System 7.0 or higher, 850k of disc space, and 512k of free RAM (preferred 1.5 MB).
  25.  
  26. ACE! is distributed as a fat binary, meaning that it runs native on both 68k and PPC Macintoshes.
  27.  
  28.  
  29. Installation
  30.  
  31. You can place the ACE! application anywhere on your hard disc. It can also be run from removable media such as a floppy disc or zip drive.
  32.  
  33. The modules folder must be named "Modules", and must be present in the same folder as the ACE! application. The "Scripts" folder should not be renamed.
  34.  
  35. If you do not intend to make modules or scripts for ACE, you can discard the "Development" folder. If you do not want to use any scripts with ACE, you can discard the "Scripts" folder.
  36.  
  37.  
  38. Instructions
  39.  
  40. Before editing any save game file, always make a backup copy. Do not dispose of the backup until you have tested the edited file.
  41.  
  42. Open the ACE! application and choose the name of the game whose save files you want to edit from the Module menu. Select Open from the File menu, and choose the save game file you want to edit. Alternatively, you can simply drag the save game files onto the ACE! application icon in the Finder - the correct module will be automatically selected.
  43.  
  44. One or more windows will appear with various controls to allow you to edit the save game. When you have finished editing, select Save from the File menu to save your changes.
  45.  
  46. Choose Quit from the File menu to exit ACE. The save game is ready for use.
  47.  
  48.  
  49. Hints
  50.  
  51. • Balloon help is provided for all menu's and most dialogs.
  52.  
  53. • In a dialog, you can type the first letter of a button to 'click' it (provided there is no editable text in the dialog).
  54.  
  55. • Hold down the option key while choosing Open from the File menu to open any file. This can be useful if the save game files have lost or have changed their type/creator information, or if the file has been copied from a PC format disc. Note that this still uses the current module - it does not select a new module.
  56.  
  57. • Hold down the option key while choosing a module from the Module menu to temporarily toggle the current tabbed windows preference.
  58.  
  59. • Hold down the option key while choosing a script from the Script menu to obtain a description of the script.
  60.  
  61. • If you are using MacOS 8 and have a contextual menu extension that lets you open files with a particular application, you can use this feature to open save game files with ACE!
  62.  
  63. • Keep an alias of the ACE! application on the desktop, or in your games or documents folder, so you can use drag-and-drop to open the save game files in ACE! (Note that you may not get the module you want if there is more than one module capable of opening it.)
  64.  
  65. • Use the up/down arrow, page up/down, home and end keys to navigate lists. Press return or enter to edit the selected list item. Press delete or forward delete to remove the selected item.
  66.  
  67. • If you are using MacOS 8.5 or later (or if you have the Navigation Services Library installed), you can select multiple files in the open file dialog by shift-clicking, or by choosing the Select All command in the Edit menu.
  68.  
  69.  
  70. History
  71.  
  72. The idea behind ACE, an extensible save game editor, is not new. Nevertheless, I was motivated to write this application for many reasons:
  73.  
  74. 1. To learn how to program the MacOS.
  75.  
  76. 2. To provide a means of editing 'classic' (older) games. Although information or applications to edit save files from games such as Bard's Tale or Might & Magic existed at the time these games were popular, it is difficult, if not impossible, to obtain now.
  77.  
  78. 3. To make an editor with a good Macintosh interface. ACE! uses no fancy fonts or custom controls, but provides standard interface items such as 'Save A Copy As', 'Revert', 'Undo', forward delete and movable modal dialogs. Other Apple technologies such as the appearance manager, balloon help, navigation services and drag-and-drop are also supported.
  79.  
  80. 4. To make an application that could do more than just edit save game files. This is achieved via scriptability, which allows ACE! to be extended and used in new ways - the scripts provided are just a sample of what is possible. 
  81.  
  82. 5. To write a program that could be easily extended. ACE's plug-in modules are easy to write, requiring no programming knowledge and only a little knowledge of 'hacking'.
  83.  
  84. 6. To write a program that other people could contribute to. I hope that many people will be encouraged to write ACE! modules or scripts for their favourite games, or extend the scripts or modules provided and thereby make ACE! a group project.
  85.  
  86.  
  87. Feedback
  88.  
  89. If you have suggestions for improvements, or criticisms, please write to me! I would very much like ACE! to be a product of many people's ideas. If you would like to contribute, consider helping with one of the following:
  90.  
  91. 1. Information on the file format of save games.
  92. 2. Making new modules, or modifying existing modules.
  93. 3. Making new scripts and testing other scripting languages (Frontier, MacPearl etc).
  94. 4. Localisations to other languages.
  95. 5. Bug testing - if you find a bug, and can reproduce it, please let me know.
  96. 6. Compatibility information - does ACE! run under MacOS X, MAE, Executor, Shape Shifter?
  97.  
  98.  
  99. Credits
  100.  
  101. As ACE! has grown, so too has the number of people who have contributed to it. In particular, these people deserve special thanks:
  102.  
  103. • Todd Clements for providing the System 7.x moveable modal dialog code,
  104. • Ron Nichalson Jr. for providing the interpreter,
  105. • Martin Lai, Stephen Thornton, Phil Cotching and Andrew Ware for beta testing,
  106. • Kevin Killion for a great deal of help with scripting,
  107. • Kevin Barry and Bruce Sponagle for testing new modules,
  108. • Michael Yopp for providing new Wizardry Gold information,
  109. • Brent Heustess for extensive documentation on the Jewel of Arabia file format,
  110. • B. Nolan McCoy for help with Realmz 6 and debugging of the Realmz modules,
  111. • Hilde Kvilstad for extensive help with the Fallout module,
  112. • Mike 'the tike' Feineman for helping create and test the System Shock module,
  113. • Bryan Baldus for reporting the MacOS 9 bug, and helping test the bug-fix,
  114.  
  115. and everyone on the 'comp.sys.mac.programmer' newsgroups who has answered my questions.
  116.  
  117. Apologies to the author of the shareware RPG Odyssey (not to be confused with all the other games called Odyssey) for using the picture on the startup screen without your permission. Your game is not currently on Info-Mac, and I couldn't contact you. I think  the original picture is public domain as I have seen it used on bank catalogues etc. If anyone knows what the picture is called, or who the author is, please let me know.
  118.  
  119.  
  120. Contact Information
  121.  
  122. If you wish to contact me, please write to one of the following addresses:
  123.  
  124. Email:   drysdall@crosswinds.net
  125.  
  126. Postal:  Richard Drysdall
  127.          25/92 Bush Road
  128.          Albany
  129.          Auckland
  130.          New Zealand